home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / util / wb / MultiUsage2.lha / MultiUsage_v2.0 / Manual.English < prev    next >
Text File  |  1999-01-02  |  10KB  |  213 lines
  1.                                  *  MultiUsage  v2.0  *
  2.                                     Shareware Version
  3.  
  4.    Made by BOUCHON Guillaume
  5.    With Blitz Basic 2.1 (Acid Software)
  6.  
  7.    Copyright GUGU BEST SOFTWARE
  8.    All Rights Reserved * 1999 *
  9.  
  10.    Send me your sugestions,remarks of MultiUsage by E-mail :
  11.       bouchon@ese-metz.fr
  12.    or by postcard at the adress :
  13.       BOUCHON Guillaume
  14.       2 Rue des fleurs
  15.       30150 MONTFAUCON
  16.       FRANCE
  17.  
  18. 1 - Some notes
  19. --------------
  20.  
  21.    * If you're good in French, please see the french doc.It's contain more
  22.      informations than the English doc.
  23.    * Sorry for this fast doc but MultiUsage is not very difficult to use.
  24.    * GUGU BEST SOFTWARE have no responsability in the damages may can do this program.
  25.    * Sorry about my bad English ! I'm not English ! I'm French ! (World Champion...)
  26.    * For unknow reasons, the Blitz's debugger crash if MultiUsage runs.If you know how
  27.    to kill this bug , contact me !!!
  28. .  * This is a shareware so I invite you to register now (see chapter 6)
  29.    * MultiUsage has just been tested on an Amiga 1200 with Workbench 3.0 ,
  30.    the turbo card MTEC 68030 28 Mhz + 8 Mb of Fast.It works fine !
  31.  
  32. 2 - Using MultiUsage
  33. --------------------
  34.  
  35.    MultiUsage is a small but very powerful util.It doesn't need a powerful Amiga
  36.    and it works fine with very low memory.
  37.    The function of MultiUsage is to get more easy the using of the files with
  38.    the Workbench.On the WorkBench,when you double click on a file
  39.    ,you have to type very long Cli command for a type of file.Per example, when you
  40.    double click on a Lha archive,you must type Lha x <file> <destination> for each
  41.    archive.It's very long and boring !! But with MultiUsage, all the disagreement of
  42.    the Workbench will deseapear !! It's easiest and fastest than all the other programs
  43.    which have tried to get more easy the using of the files (like NewIcons,Directory
  44.    Opus,...)
  45.    When MultiUsage is running (first,you have to install it), a new icon appear on the
  46.    Workbench' screen.When you drop one or many files on this icons, if the type of the
  47.    file is recognize,the good program will be used with this file automaticelly !
  48.    Per example, you have dropped gugu.lha,MultiUsage will call Lha automaticelly !!
  49.    Or if you drop gugu.gif , a Gif Viewer like Viewtek will be call ! It's super !
  50.    To recognize a type of file,you must create a filetype to MultiUsage with Filetype
  51.    Editor (see chapter 5).
  52.  
  53. 3 - Shareware version
  54. ---------------------
  55.  
  56.    On Internet,in the magazine's Cds or disks..., MultiUsage version 2.0 is only
  57.    Shareware.If you have a registered version and you have never registered it, you
  58.    have got a pirate version.You have to kill it immediatelly and to get a good version of
  59.    MultiUsage.
  60.    MultiUsage is shareware so it doesn't contain all the features of the registered
  61.    version.If you like this util, please register now (see chapter 6).In the version
  62.    shareware, you can only use 10 filetypes so it is very limited.It's the only
  63.    difference between the registered and shareware version.But if you're registered,
  64.    you will informed about all the news of GUGU BEST SOFTWARE and you will be offered
  65.    the new versions of MultiUsage gratuitious.
  66.  
  67. 4 - Installation on the Hard Disk
  68. ----------------------------------
  69.  
  70.    MultiUsage is very easy to install so I didn't make an install program.
  71.    To install MultiUsage, just follow the instructions : 
  72.          - Open the Cli or the Shell in the Workbench
  73.          - Go in the MultiUsage directory (ex: Hd:internet/multiusage/)
  74.          - Type : C:Copy MultiUsage_v2.0.english to C: (or MultiUsage_v2.0.français)
  75.          then validate.
  76.          - Type : C:Rename C:MultiUsage_v2.0.english to C:MultiUsage
  77.          then validate.
  78.          - Type : C:Copy FileType_Editor.english to C:
  79.          then validate.
  80.          - Type : C:Rename C:Filetype_Editor.english to C:Filetype_Editor
  81.          then validate
  82.          - Type : C:Copy fonts/ to Fonts: all
  83.          then validate
  84.          - Type : C:Copy s/ to S: all
  85.          then validate
  86.          - Now modify your startup-sequence (or user-startup) : add BEFORE C:Endcli >nil:
  87.             C:Run <>nil:   C:MultiUsage
  88.          - ReRun your Computer .
  89.    Normally, MultiUsage will work fine.
  90.  
  91. 5 - Using FileType Editor
  92. -------------------------
  93.  
  94.    When Filetype Editor is launching, a new window appear on the Workbench' screen.
  95.    At the left of the window, there is the list of the filetypes created.A filetype
  96.    is used to recognize the files.In this version of MultiUsage, the files are only
  97.    recognize by their names.Per example, for a Lha archive, the filetype is .lha .
  98.    Or for a Gif picture,the filetype is .Gif. So all the files which finish by .lha or
  99.    .gif will be recognize and a script will be execute.This script must be write on the
  100.    right of the window.
  101.  
  102.    * Writing a script for a filetype *
  103.  
  104.    The script can contain AmigaDos commands like C:Lha or C:Vt or it can contain
  105.    MultiUsage commands.All the MultiUsage commands begin by % and the AmigaDos commands
  106.    begin with nothing.On a line, there can be only one AmigaDos command and an
  107.    infinity of MultiUsage commands.I will not talk about the AmigaDos commands because
  108.    everybody know what are they but I will talk about the MultiUsage commands.These
  109.    commands make more powerful the script.All these commands begin by %. To show you
  110.    all the powerful and necessity of these commands, lets examinate this example :
  111.    This is a script for the .lha filetype :
  112.       C:Lha x %f %pr
  113.    It's all ! It seems complicated but it's very easy.If you drop a lha archive, a
  114.    path requester will appear to ask you where you want to dearchive the file.All of
  115.    this in only one line !
  116.    The synopsis of the AmigaDos command Lha is <option> <file> <destination>
  117.    Here, C:Lha is the AmigaDos command. 'x' seems that we want to dearchive.
  118.    %f and %pr are MultiUsage commands.When the script is executed,%f is replaced
  119.    by the name of the file dropped and %pr is replaced by the name of the path
  120.    selected by a path requester (after opening).So if you have dropped gugu.lha and
  121.    selected the directory ram: , MultiUsage execute : C:Lha x gugu.lha ram:.
  122.    For a Gif picture,you have to type  : C:Vt %f (Vt is a Gif viewer)
  123.    Note : A MultiUsage command can have arguments.These arguments must be separate
  124.    by # of the name of the command.Example : %pr#"Please select a Path ?"
  125.    "Path ?" is a text argument.The %pr command will open a path requester with the
  126.    title 'Please select a Path ?'
  127.  
  128.    Here there are all the MultiUsage commands and their effects:
  129.       %f             :  Replace %f by the name of the file dropped
  130.       %pr            :  Replace %pr by the name of the path selected with a path
  131.                         requester
  132.                         Other synopsis : %pr#"title"   => set the title of the requester
  133.                                          %pr#drop      => name between " "
  134.       %fr            :  Replace %fr by the name of the file selected with a file
  135.                         requester
  136.                         Other synopsis : %fr#"title"   => set the title of the requester
  137.                                          %pr#drop      => name between " "
  138.       %lf            :  Replace %lf by the name of the last file selected by a requester
  139.       %lp            :  Replace %lp by the name of the last path selected by a requester
  140.       %mousewait     :  Wait the user to push a mouse button
  141.       %sameas#filetype :  Use the script of another filetype
  142.       %stop          :  Stop the execution of the script
  143.       %message#"text" : Open a window with a message
  144.       %killmessages  : Close the window with the messages
  145.       %wait#time     : Wait some times
  146.  
  147.    Some commands of MultiUsage are tests.There are very useful in a script.These tests
  148.    are in loops (like in the basic : IF test ... ENDIF).If the test is true, the loop
  149.    is executed else it's ignored.All the loop finish by %endcond.
  150.    Note : In this version, a loop can't contain more than one test.
  151.    Here, there is an example to understand what I said :
  152.       %fileexists
  153.       %message#"The file exists !!!"
  154.       %endcond
  155.  
  156.    In this example, if the file exists (the file selected by a requester), the
  157.    message 'The file exists !!!' will apear.Else, it won't appear
  158.    Here there is the list of all the tests and loops :
  159.       %fileexists    :  Test if the file selected by a requester exists.
  160.       %filenotexists :  Test if the file selected by a requester doesn't exist
  161.       %pathnotexists :  Test if the path selected doesn't exist
  162.                         Caution : This command have some problems.
  163.       %pathexists    :  Test if the path selected exists (see %pathontexists)
  164.       %else          :  If the test isn't true,script continues after %else
  165.       %endcond       :  Close the loop
  166.  
  167.    Here there is a big script for a Lha archive :
  168.       %message#"This is a Lha archive !!"
  169.       %pr#"Destination path ?"
  170.       %pathexists
  171.       C:Lha x %f %lp
  172.       %wait#100
  173.       %else
  174.       %message#"The path doesn't exists !!!"
  175.       %wait#100
  176.       %endcond
  177.       %killmessages
  178.  
  179. 6 - Registration
  180. ----------------
  181.  
  182.       To be registrered, you have to send by e-mail or by postcard at these adress :
  183.        E-mail:    bouchon@ese-metz.fr
  184.        Mail:      BOUCHON Guillaume
  185.                   2 Rue des fleurs
  186.                   30150 MONTFAUCON
  187.                   FRANCE
  188.  
  189.       this tiket filled and a small cheque :
  190.  
  191.       SURNAME: ------------------------  NAME: --------------------------
  192.  
  193.       E-Mail:  -------------------------- (you must fill this  !)
  194.  
  195.       Adress:  --------------------------
  196.                --------------------------
  197.                --------------------------
  198.  
  199.       City:   --------------------------
  200.  
  201.       Postal code : ---------------------
  202.  
  203.       Country:    --------------------------
  204.  
  205.       NOTE VERY IMPORTANT :To get registered, you must send me (by mail only) a
  206.       small cheque of 20 Francs Français or 3,05 euros at the order of BOUCHON
  207.       Guillaume.
  208.  
  209.       You will receive a registration number which you will must type it in the
  210.       registration program.
  211.  
  212.       Thanks you ! 
  213.